home *** CD-ROM | disk | FTP | other *** search
/ CD ROM Paradise Collection 4 / CD ROM Paradise Collection 4 1995 Nov.iso / graphics / st158.zip / README.TXT < prev    next >
Text File  |  1994-10-25  |  7KB  |  166 lines
  1.  
  2. Welcome to SCREEN Thief! The following instructions will show you
  3. how to install the software and get up and running in next to no
  4. time. They will also contain details of any last minute changes
  5. not documented elsewhere.
  6.  
  7.  
  8. Installation
  9. ------------
  10.  
  11. To install SCREEN Thief, insert the disk supplied into a drive
  12. and then select that drive by typing "A:" or "B:" as appropriate
  13. followed by <ENTER>. Next, type "INSTALL", press <ENTER> and
  14. follow the on-screen instructions. You will be asked for a
  15. destination drive and path for SCREEN Thief which default to
  16. "C:" and "\ST" respectively. Change these if necessary, although
  17. it will be easier to stay with the defaults as they will be used
  18. in the various examples.
  19.  
  20.  
  21. Running SCREEN Thief
  22. --------------------
  23.  
  24. To run SCREEN Thief with the default settings, change to the
  25. "\ST" directory and simply type "ST". SCREEN Thief will then be
  26. installed and you can run whatever program you need to grab a
  27. screen from. To actually grab a screen, press the <CTRL>, <ALT>
  28. and <T> keys together and you will hear a clicking noise from
  29. your PC speaker as SCREEN Thief is working. The image file
  30. produced will be in colour GIF format and given a name
  31. consisting of the first 6 letters of the name of the program
  32. currently being run followed by a number, eg, "FILENA01.GIF".
  33. This file will be saved to the current directory but you can
  34. specify a different directory when you run SCREEN Thief as
  35. follows:
  36.  
  37. ST C:\CAPTURE
  38.  
  39. This will save all captured image files to the "C:\CAPTURE"
  40. directory.
  41.  
  42.  
  43. The Command Line
  44. ----------------
  45.  
  46. All of SCREEN Thief's operational characteristics are controlled
  47. by command line parameters, mostly switches. Once installed, all
  48. changes to the way SCREEN Thief operates can only be made via
  49. the command line. All the various command line parameters are
  50. covered in detail in the Reference Section of this manual, but
  51. the more commonly used ones will be covered here. These
  52. parameters are:
  53.  
  54. /OUTPUT Sets the Output Image File Format to either GIF, TIFF,
  55. PCX or BMP. The default setting is GIF and the syntax of this
  56. switch is /O:TIFF.
  57.  
  58. /MONO   Enables and disables Mono Translation, ie, producing a
  59. black and white image. The default setting is disabled and the
  60. syntax of this switch is /M+ to enable and /M- to disable.
  61.  
  62. /UNLOAD Removes SCREEN Thief from memory. This is the only way
  63. to correctly remove SCREEN Thief from memory; do not use
  64. programs such as MARK and RELEASE. The syntax of this switch is
  65. /U.
  66.  
  67. Example
  68.  
  69. To use SCREEN Thief to capture screens and output them in mono
  70. PCX format to a directory called C:\PICTURES, type the following:
  71.  
  72. ST C:\PICTURES /M+ /O:PCX
  73.  
  74. Once SCREEN Thief is loaded in this way, you could then, for
  75. example, change the output file format by typing the following
  76. from the \ST Directory:
  77.  
  78. ST /O:GIF
  79.  
  80. Each time you make a change, the SCREEN Thief window will pop up
  81. showing the new setup.
  82.  
  83.  
  84. The SCREENTHIEF Environment Variable
  85. ------------------------------------
  86.  
  87. If you regularly use a particular setup for SCREEN Thief that is
  88. not the same as the default setup, you can avoid having to type
  89. all the command line switches each time, as in the example
  90. above, by using an environment variable. This is a string
  91. containing the required command line parameters that is placed
  92. in the AUTOEXEC.BAT file using the DOS SET command as in the
  93. example below:
  94.  
  95. SET SCREENTHIEF=C:\PICTURES /M+ /O:PCX
  96.  
  97. This will then use these parameters every time SCREEN Thief is
  98. run, overriding the defaults so that you only need to type "ST"
  99. to access your most used setup. The command line parameters will
  100. override the environment variable so you can still run SCREEN
  101. Thief differently as necessary.
  102.  
  103.  
  104. The SCREEN Thief Configuration File
  105. -----------------------------------
  106.  
  107. Although the Environment Variable allows you to set SCREEN Thief
  108. up to a certain extent, you may have various configurations for
  109. specific tasks that you would like to automate. This is possible
  110. using the Configuration File. Any parameters on the command line
  111. (or within the SCREENTHIEF environment setting) which do not
  112. follow a switch character will first be compared against the
  113. Configuration File. This is a simple text file such as can be
  114. created with any text editor or word processor in ascii mode. It
  115. must be called CONFIG.ST and exist in the same directory as the
  116. ST executable file. 
  117.  
  118. Configuration entries are implemented in the same way as the
  119. environment string, but each is preceded with a unique name.
  120. Each configuration must start on a new line, with a maximum line
  121. length of 255 characters including the config name. Any
  122. characters beyond this are truncated. For example:
  123.  
  124. REVIEWS=N:\PUB\REVIEWS\PCX /RGB+ /M- /O:PCX /K:50 /SH:OFF
  125. BOOKS=N:\PUB\BOOKS\GRABS /RGB- /MONO /O:GIF /K:01 /SH:CL
  126.  
  127. This allows easy switching between different configurations
  128. based solely on a customer, project or user name. However, note
  129. that any option changed in one configuration will need to be
  130. changed in every other configuration unless valid for all cases.
  131.  
  132. Configuration names are allowed within the environment string
  133. and on the command line. Multiple configuration names are also
  134. permitted, but nesting is not. This means that a config entry
  135. cannot name another within its command line. Configurations can
  136. also be used in isolation or in addition to other command line
  137. switches.
  138.  
  139. If no matching entry is found within the CONFIG.ST file SCREEN
  140. Thief will then attempt to use it as an image file directory
  141. name and check its validity accordingly.
  142.  
  143.  
  144. The Help System
  145. ---------------
  146.  
  147. SCREEN Thief has an extensive help system that may be used in
  148. one of two ways. Firstly, if an error occurs, the help system
  149. will be automatically started, the error message displayed and
  150. the correct subject highlighted. Simply press the right-arrow
  151. key to expand the help screen for further information. Please
  152. note that not all errors will produce this automatic help; some,
  153. such as "Directory Non Existent" that are self-explanatory, just
  154. bring up an error message and quit the program.
  155.  
  156. Secondly, the help system may be started without actually
  157. loading SCREEN Thief, by typing "ST /?" from the "\ST"
  158. directory. You will see the SCREEN Thief window on the screen at
  159. this point containing a list of help subjects. Select the
  160. subject you require using the up-arrow and down-arrow keys and
  161. then press the right-arrow key to expand the help screen. Where
  162. applicable, use the up-arrow and down-arrow or the page-up and
  163. page-down keys to view the text in the expanded help screen. The
  164. left-arrow key will return you to the list of help subjects.
  165.  
  166.